home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 501-525 / disk_521 / k1 / k1.doc next >
Text File  |  1992-05-06  |  14KB  |  316 lines
  1. ================================================================================
  2. =                               K1-II Librarian                                =
  3. =                            Version 4.0 or higher                             =
  4. =                                                                              =
  5. =                        Written in 1990/91 and (C) by                         =
  6. =                                Andreas Jung                                  =
  7. =                              Klosterstrasse 21                               =
  8. =                              D-6602 Dudweiler                                =
  9. =                         Federal Republic of Germany                          =
  10. =                                                                              =
  11. =                            All rights reserved !                             =
  12. ================================================================================
  13.  
  14.  
  15. COPYRIGHT NOTICE/DISTRIBUTION
  16. -----------------------------
  17. This program is not public domain.  All rights are reserved to the author.  But
  18. the program may be freely distributed for noncommercial use.  Commercial use or
  19. commercial  distribution  of  any  kind  requires the written permission of the
  20. author.   If  you  want  to distribute this program in a PD-library, you should
  21. write  to  me  and you will get a special release version for your library.  If
  22. you  want  to contact me, please enclose any form of payment for package, disks
  23. etc.   Suggestions, bug-reports and donations of any kind (except letter bombs)
  24. are always welcome.
  25.  
  26.  
  27. OVERVIEW:
  28. --------
  29. The  K1-Librarian  is  a  program  for use with the Kawai K1-II synthesizer via
  30. MIDI.  The current version includes a bankloader for single- and multi-patches,
  31. a  singlepatch-editor,  a  multipatch-editor and support for the effect-session
  32. and  K1  controllers.   The  program is totally mouse controlled.  All possible
  33. actions  are  selected with the mouse.  I did not use pulldown menus for a most
  34. efficient use of this program.
  35.  
  36.  
  37. REQUIREMENTS:
  38. -------------
  39. First  you  need  a Kawai K1-II synthesizer and a MIDI-interface connected with
  40. your Amiga.  I do not know if my program works with the older K1 models; let me
  41. know  !   It  should  work with any Amiga with Kickstart Version 1.2 or higher.
  42. K1-Librarian  was  developed  under  Kickstart  1.3  with  Aztec-C  5.0 and was
  43. successfully  tested  under  Kickstart  2.0  The K1-Librarian should run on any
  44. Amiga with at least 512 KB.
  45.  
  46. Ensure that the following files are in right directories:
  47.  
  48.                                LIBS:arp.library
  49.                                LIBS:req.library
  50.                                LIBS:midi.library
  51.                              LIBS:diskfont.library
  52.                                LIBS:icon.library
  53.                                  L:ram-handler
  54.                                 L:port-handler
  55.                               DEVS:printer-device
  56.                               DEVS:serial.device
  57.                        DEVS:printers/<printerdriver>    
  58.                             
  59.  
  60. CREDITS:
  61. --------
  62. First  I  want to thank Michael Balzer, the author of the K1-Editor released on
  63. AmigaLibDisk  332  (by Fred Fish).  The sources of his editor were very helpful
  64. during  the  development of this program.  He also send me the documentation of
  65. the Req-Library.
  66.  
  67. Also   thanks   to   Colin   Fox   of  Pyramid  Designs  and  Bruce  Bawson  of
  68. CygnusSoft-Software  for  the fine Req-Library and to people of Pregnant Badger
  69. Music which wrote the Midi-Library (released on AmigaLibDisk 227)
  70.  
  71. Thanks  to  Timm  Martin  for  the  release  of the sources of his sleepy mouse
  72. pointer and the input-device routine (released on AmigaLibDisk 430)
  73.  
  74. Thanks  to  Paris  E.   Bingham  Jr.   who wrote the input handler (released on
  75. AmigaLibDisk 446)
  76.  
  77. Thanks to Fred Fish for his engagement in Amiga-PD.
  78.  
  79.  
  80. INSTALLATION:
  81. -------------
  82. First copy the files in the drawer LIBS to your work-disk.  Ensure that all the
  83. files  above  are  in  right  drawer.  Now make new drawer called KAWAI on your
  84. (hard)disk and make a assign to it:        ASSIGN KAWAI:  KAWAI 
  85. Next  you should copy the drawers SOUNDS, BANKS, DUMP and MULTI to the assigned
  86. directory  KAWAI:   I should be enough.  The K1-Librarian can be started either
  87. from the CLI or from the workbench.  The following CLI options are recognized:
  88.  
  89.         'K1 s' - open a custom screen
  90.         'K1 l' - open a interlaced custom screen
  91.         'K1 g' - get single- and multi-patch dump
  92.         'K1 i' - initalize all patches by default
  93.  
  94. If you want more than on option, they must by seperated by a blank:
  95.       e.g. 'K1 l g' - open interlaced custom screen and get single/multi-patch
  96.  
  97. Workbench support: The following tool-types are recognized:
  98.  
  99.         SCREEN=ON/OFF
  100.         LACE=ON/OFF
  101.         GETDUMP=ON/OFF
  102.         INITIALIZE=ON/OFF
  103.         MULTIDIR=directoryname
  104.         BANKDIR=directoryname
  105.         DUMPDIR=directoryname
  106.         SOUNDDIR=directoryname
  107.         DEFAULTDUMP=dumpname
  108.  
  109. K1-Librarian  will open an interlace screen if it is run on a ntsc amiga.  This
  110. is  nessecarry  because  the  program  needs  a  lot  of  space  to display the
  111. synthesizer informations.
  112.  
  113.  
  114. OTHER MIDI SOFTWARE
  115. -------------------
  116. K1-Librarian uses the Midi-Library.  All programs which use this library may be
  117. started  at  the  same  time.   But there are some programs that can not be run
  118. simultaneously  with  K1-Librarian.   One  program  is  e.g.   the Steinberg 24
  119. sequencer.  On the other side Bars & Pipes seems to work without problems.
  120.  
  121.  
  122. CHANNEL-NUMBERS:
  123. ----------------
  124. When  you  start  the  Librarian, it will check on which midi channel the K1 is
  125. sending.  It is not neccessary to select a special transmit or receive channel.
  126. The Librarian automatically recognizes the receive channel and remembers of it,
  127. when  it  will  send some data to the K1.  Therefore you not change the receive
  128. channel of the K1 because there may be a malfunction of the Librarian.
  129.  
  130.  
  131. BANK-ORGANISATION
  132. -----------------
  133. The K1 has space for 64 single patches. They are organised in two banks:
  134.                            Bank 1: A1 - D7
  135.                            Bank 2: a1 - d7
  136.  
  137.  
  138. GETTING STARTED:
  139. ----------------
  140. When  you run K1-Librarian, it will open a window with a field of 4 columns and
  141. 16  rows.   This  field  represents the 64 single patches of the K1-II.  In the
  142. lower half of the window there is the control with the following options:
  143.  
  144.     Load Bank 1/2:     Load a file with a soundbank (32 single patches) 
  145.     Save Bank 1/2:     Save current bank from Amiga to disk
  146.     Get Bank 1/2:      Get bankdump from K1
  147.     Send Bank 1/2:     Send current bank to K1
  148.     Save Sounds 1/2:   Save the sounds of the current bank to disk. They will
  149.                        be put in the directory KAWAI:SOUNDS
  150.     Load/Send as 1/2:  A bankfile is directly send from disk to K1 without
  151.                        changing the current banks of the K1-Librarian.
  152.     About:             This option will open a requester with informations
  153.                        about my program.
  154.     Iconify:           The program's window will be iconified when you select
  155.                        this option. The window can be resized by activating the 
  156.                        iconified window and pressing the right mousebutton. 
  157.     1-16:              Select a program of the effect session (only K1-II)
  158.         
  159.  
  160. The  field MULTI in the right upper corner switches to the multi-patch section.
  161. Here  we  have  a  field  for  the  32  multi-patches.   Following  options are
  162. available:
  163.  
  164.     Load Multi:        Load multi-patch from disk
  165.     Save Multi:        Save multi-patch to disk
  166.     Get Multi:         Get multi-patch from K1
  167.     Send Multi:        Send multi-patch to K1
  168.     Load Dump:         A dump consists of two single-patches banks and one
  169.                        multi-patch-bank.
  170.     Save Dump:         Save dump to disk
  171.     Get Dump:          Get complete dump from K1
  172.     Send Dump:         Send current Librarian banks as dump to K1
  173.     Colors:            Opens a color requester to change the screen colours.
  174.                        The colours are saved to disk. 
  175.     Init all:          All single- and multi-patches will be reseted to the 
  176.                        factory patches 'Single K-1' and 'Multi-K1'
  177.     Change screen:     Toggle between workbench and custom screen 
  178.     Controllers:       Show some gadgets for master K1-II controlls e.g. 
  179.                        mastervolume, pitchbender and modulation wheel        
  180.  
  181. The proportional gadget on the right side changes the master volume of the K1.
  182.  
  183.            
  184. USE OF MOUSE:
  185. -------------
  186. Move  the  mousepointer  to field with a single- or multi-patch.  Now press the
  187. right mouse button.  The current patch will be transmitted to the K1.  When you
  188. press  the left button over a single-patch or multi-patch, a small requester is
  189. opened with the following possiblities:
  190.  
  191.  Single-Patches:
  192.  ---------------
  193.     Load sound:        Load sound from disk
  194.     Save sound:        Save sound to disk        
  195.     Edit sound:        Switch to single-patch editor (see below)
  196.     Transmit sound:    Send current sound to K1
  197.     Copy to:           Copy current patch to other position. Select
  198.                        destination by clicking to the wished position
  199.     Swap with:         Swap current patch with another patch
  200.     Cancel:            Close and leave requester    
  201.  
  202.  Multi-Patches:
  203.  --------------
  204.     Edit multi:        Switch to multi-patch editor (see below)
  205.     Transmit multi:    Send current multi-patch to K1
  206.     Copy to:           Copy current multi-ptahc to other position. Select
  207.                        destination by clicking to the wished position
  208.     Swap with:         Swap current patch with another patch
  209.     Cancel:            Close and leave requester    
  210.  
  211.  
  212. SINGLE-PATCH-EDITOR:
  213. --------------------
  214. The  single-patch  editor  is the heart of the K1-Librarian.  All parameters of
  215. any  sound  are displayed and can be changed.  Please refer to your K1 handbook
  216. for  detailed informations about the different parameters.  To edit a parameter
  217. do the following:  Move mouse-pointer over the parameter you wish to change and
  218. press  the  left  mouse button.  A small window with a proportional gadget will
  219. appear.   Now  move  the  gagdet  to  the  desired  value.  Leave the window by
  220. pressing the right (!) mouse button. 
  221.  
  222. The  program will send the changed parameter in realtime to the K1.  This means
  223. that  you  can  press  some keys on your K1 and hear directly the change of the
  224. selected sound.  So you can immediately test your sound creation.  The KS-curve
  225. and  the  VEL-curve are displayed graphically.  They can be changed by clicking
  226. on the desired field.
  227.  
  228. Warning:   Don't  change the single sound patch during editing a special sound.
  229.            All sound parameters concern the K1 selected sound
  230.  
  231.  
  232. MULTI-PATCH EDITOR:
  233. -------------------
  234. The multi-patch editor gives you the abelity to edit the multi-patches.  Please
  235. refer  to  your  K1  handbook for detailed informations.  All parameters can be
  236. changed  by  clicking  in  the  required field.  Either the field contents will
  237. change  or  a  window with a proportional gadget will appear.  In this case you
  238. can leave this window by pressing the right(!) button.
  239.  
  240. The  proportional  gadget  on  the  right  side  will change main volume of the
  241. current patch.
  242.  
  243. You can leave the editor by clicking in the 'OK' field.  The current parameters
  244. are  immediately send to the K1.  Clicking to the 'Chancel' field will have the
  245. effect  that  all changes are ignored and the old parameters are restored.  The
  246. 'Print'  option  will  print  the parameter table to you printer.  This version
  247. uses  the  PRT-device.   Last  but  not lest, the 'Rename' option allows you to
  248. change the name of the selected multi-patch.
  249.  
  250. The  gadgets  under  the  editor  block  allows you to reset some parameters to
  251. default values:
  252.     
  253.     ZoneLow:    Default: C-2
  254.     ZoneHigh:    Default: G-8
  255.     Channel:    Default: Ch. 1-8
  256.     Mode:        Default: MIX
  257.     Poly:        Default: VR    
  258.  
  259.  
  260. ERROR-MESSAGES:
  261. ---------------
  262. 'Can't open XXX.library':
  263.         The program can not open the XXX.library.  You should
  264.         copy the required library to the LIBS:  directory and
  265.         then start the K1 Librarian again.
  266.  
  267. 'Can't create midi destination', 'Can't create midi route destination',
  268. 'Can't create midi route source':
  269.         One  of  these messages will appear if another program is
  270.         running  which uses and allocates the serial device, e.g.
  271.         if your are running a midi sequencer.  Finish all running
  272.         programs which are using the serial device and then start
  273.         the K1 Librarian.
  274.     
  275. 'Can't open xxx-window', 'Can't open xxx-screen':
  276.         One  of  these  messages will appear if the program can't
  277.         open  a  screen or a window.  This can happen if there is
  278.         to  few  chip  memory  available.   Close other window of
  279.         others tasks of save some chip memory.
  280.  
  281.  
  282. INPUT-HANDLER
  283. -------------
  284. The program will launch an input handler.  Its task is to check the inputevents
  285. for the combination of RIGHT SHIFT and BACKSPACE.  If both keys are pressed the
  286. program's  window  or  screen will be prompted to front.  This is neccessary if
  287. you have "lost" the programs window.
  288.  
  289.  
  290. BUG-FIXES
  291. ---------
  292. K1  Librarian switched to multi-patch d8 when selecting effect number 1.  Fixed
  293. in version 5.0 (Reported from David Ingebretsen, Salt Lake City)
  294.  
  295. There was a small bug in the single-patch editor when changing the velcurve and
  296. the  pressure  on  frequency parameters.  Fixed in version 5.0.  (Reported from
  297. David Ingebretsen, Salt Lake City)
  298.  
  299.  
  300. BUGS
  301. ----
  302. There  may be problems when running K1-Librarian and other midi software at the
  303. same  time, especially when you are trying to interchange SysEx-Data from or to
  304. K1.   When  you request a single- or multi-patch dump, the Librarian will check
  305. if  a  K1  is  connected to the system.  But there seems to be a problem in the
  306. K1-check-routine.   Sometimes  the  Librarian does not recognize a connected K1
  307. and  sends  an  error  message.   This  bug seems to be fixed in version 3.5 or
  308. later.
  309.  
  310. Perhaps  there may be other smaller bugs.  Please let me know if you think that
  311. you should found one.
  312.  
  313. ********************************************************************************
  314. ********************************************************************************
  315. ********************************************************************************
  316.